Introducción a n8n: Conceptos claves e Instalación con Docker Compose

Introducción a n8n: Conceptos claves e Instalación con Docker Compose

por Raúl Unzué

Qué es N8N

Si has oído hablar de n8n y al entrar te has encontrado con palabras como workflow, node, trigger o webhook, no eres el único. A mucha gente le pasa lo mismo, ve una herramienta visual, intuye que sirve para automatizar cosas, pero no termina de entender qué hace exactamente ni cómo empezar sin perderse en la jerga.

La idea de este artículo es justo esa, explicarte qué es n8n en 2026, para qué sirve de verdad, qué significa cada término importante y cómo dejarlo instalado con Docker Compose de una forma razonable para empezar. n8n se sigue presentando hoy como una plataforma de automatización de workflows, con despliegue self-hosted y documentación oficial para Docker y Docker Compose. Además, sus release notes muestran que sigue recibiendo actualizaciones frecuentes, la rama estable que figura ahora mismo en la documentación es la 2.12.3.

n8n es una herramienta para automatizar procesos y conectar sistemas entre sí. En vez de hacer tareas repetitivas a mano, puedes montar un flujo que las haga por ti. La documentación oficial lo define como una plataforma de automatización, y su web la presenta como una solución flexible para construir flujos técnicos y de negocio.

Llevado a algo más cotidiano, n8n te puede servir para:

  • Recoger datos de una API
  • Transformarlos
  • Guardarlos en una base de datos
  • Mandar una alerta
  • Crear una tarea
  • O encadenar varias aplicaciones para que trabajen juntas.

La gracia de n8n es que mezcla una interfaz visual con la posibilidad de meter lógica más avanzada cuando la necesitas. No se queda solo en “arrastrar cajitas”, también te deja escribir expresiones, usar código y montar automatizaciones bastante serias.

Geeknetic Introducción a n8n: Conceptos claves e Instalación con Docker Compose 1

Vocabulario de n8n

A continuación, os vamos a explicar varios términos repetidos en n8n y hay que entender cuando empiezas con la herramienta.

Workflow

Un workflow es el flujo completo. Es el proceso entero que quieres automatizar.

  • Ejemplo: Llega una petición, n8n la procesa, guarda los datos y manda una notificación. Todo eso junto es un workflow. La documentación lo describe como una colección de nodos que automatizan un proceso.

Node

Un node es cada bloque dentro del workflow. Cada nodo hace una tarea concreta.

  • Uno puede iniciar el flujo, otro consultar una API, otro filtrar datos y otro guardarlos en una base. Si el workflow es la cadena completa, el node es cada eslabón.

Trigger

Un trigger es el disparador. Es lo que hace que el workflow arranque.

  • Puede ser una hora concreta, un evento externo o una llamada desde otra aplicación.

Schedule Trigger

Es un trigger basado en tiempo.

  • Sirve para decir: “Ejecútate cada día a las 08:00” o “cada 15 minutos”. n8n lo documenta como el nodo pensado para automatizaciones programadas.

Webhook

Un webhook es una URL que espera recibir algo.

  • Cuando otro sistema llama a esa URL, n8n reacciona. Es una puerta de entrada para eventos externos. La documentación oficial también lo describe así, un endpoint que puede iniciar un workflow al recibir una petición.

HTTP Request

Es uno de los nodos más útiles.

  • Sirve para hacer peticiones HTTP a APIs y servicios web. Si una herramienta tiene API, muchas veces podrás integrarla con n8n usando este nodo, aunque no exista integración nativa.

Credential

Una credential es una credencial guardada dentro de n8n.

  • Sirve para no ir pegando usuarios, contraseñas o tokens en cada nodo. Puedes guardar accesos a bases de datos, APIs o servicios externos.

Expression

Una expression es una forma de usar datos dinámicos dentro de un nodo.

  • Suena más raro de lo que es: básicamente, reutilizar información que viene de otro bloque del workflow.

Execution

Una execution es una ejecución concreta del flujo.

  • Cada vez que un workflow corre, queda registrada una execution. n8n diferencia entre ejecuciones manuales y de producción, y permite revisarlas desde la interfaz para ver qué pasó en cada paso.

 

Porque ocupa un punto intermedio muy interesante. Hay herramientas más simples para automatizaciones rápidas, pero se quedan cortas cuando quieres control.

Y hay plataformas mucho más pesadas, pero demasiado complejas para empezar. n8n ofrece interfaz visual, self-hosting, integraciones, lógica flexible y posibilidad de escalar tus flujos sin salirte de la misma herramienta. Además, su documentación sigue manteniendo una Community edition para uso sin licencia y opciones Business o Enterprise para entornos con licencia.

Antes de instalarlo: Una advertencia sensata

Conviene decirlo claro, self-hostear n8n no es darle a dos botones y olvidarte. La propia documentación indica que el despliegue propio requiere ciertos conocimientos técnicos sobre servidores, contenedores, recursos, configuración y seguridad, y recomienda este modelo a usuarios con experiencia suficiente para operar el entorno.

No hace falta ser un administrador veterano, pero sí conviene tener unas nociones mínimas de Docker, puertos, persistencia y variables de entorno.

Cómo instalar n8n con Docker Compose

Para empezar bien, una instalación sencilla y razonable es levantar dos servicios:

  • n8n
  • PostgreSQL

n8n puede funcionar por defecto con SQLite, pero soporta PostgreSQL y, si quieres algo más serio desde el principio, es mejor montarlo así. La documentación también deja claro que MySQL y MariaDB quedaron obsoletos como backend desde la versión 1.0.

Crear una carpeta de trabajo para datos persistentes

El primer paso es crear una carpeta (n8n) y dos subcarpetas (n8n_data y postgres_data) donde se guardarán los datos persistentes. Yo usaré un NAS Asustor con Portainer para lanzar el stack:

Geeknetic Introducción a n8n: Conceptos claves e Instalación con Docker Compose 2

 Crear Stack en Portainer

Accedemos a Portainer -> Stacks y generamos uno nuevo:

Geeknetic Introducción a n8n: Conceptos claves e Instalación con Docker Compose 3

Usaremos las carpetas persistentes en el volumen correspondiente, en el ejemplo "/volume2/Docker/n8n":

version: "3.9"

services:

  postgres:

    image: postgres:16

    container_name: n8n-postgres

    restart: unless-stopped

    environment:

      POSTGRES_DB: ${POSTGRES_DB}

      POSTGRES_USER: ${POSTGRES_USER}

      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}

    volumes:

      - /volume2/Docker/n8n/postgres_data:/var/lib/postgresql/data

  n8n:

    image: docker.n8n.io/n8nio/n8n:latest

    container_name: n8n

    restart: unless-stopped

    ports:

      - "5678:5678"

    environment:

      DB_TYPE: postgresdb

      DB_POSTGRESDB_HOST: postgres

      DB_POSTGRESDB_PORT: 5432

      DB_POSTGRESDB_DATABASE: ${POSTGRES_DB}

      DB_POSTGRESDB_USER: ${POSTGRES_USER}

      DB_POSTGRESDB_PASSWORD: ${POSTGRES_PASSWORD}

      N8N_ENCRYPTION_KEY: ${N8N_ENCRYPTION_KEY}

      GENERIC_TIMEZONE: ${GENERIC_TIMEZONE}

    depends_on:

      - postgres

    volumes:

      - /volume2/Docker/n8n/n8n_data:/home/node/.n8n

Deberemos adicionalmente, definir variables. Estas variables sirven para definir la base de datos, el usuario, la contraseña, la clave de cifrado interna de n8n y la zona horaria. La documentación de n8n recoge N8N_ENCRYPTION_KEY y GENERIC_TIMEZONE dentro de su configuración por variables de entorno.

POSTGRES_DB=n8n

POSTGRES_USER=n8n

POSTGRES_PASSWORD=cambia_esto_por_una_password_larga

N8N_ENCRYPTION_KEY=cambia_esto_por_una_clave_muy_larga_y_unica

GENERIC_TIMEZONE=Europe/Madrid

Geeknetic Introducción a n8n: Conceptos claves e Instalación con Docker Compose 4

Pulsamos "Deploy the stack":

Geeknetic Introducción a n8n: Conceptos claves e Instalación con Docker Compose 5

Una vez lanzado el contenedor, escuchará en el puerto "http://IP_DE_SERVIDOR:5678". Es posible que os lance este mensaje al no usar HTTPS:

Geeknetic Introducción a n8n: Conceptos claves e Instalación con Docker Compose 6

Podéis agregar una variable adicional "N8N_SECURE_COOKIE=false". En la primera carga os pedirá crear una cuenta:

Geeknetic Introducción a n8n: Conceptos claves e Instalación con Docker Compose 7

Y ya tendríamos todo listo para empezar a usarlo:

Geeknetic Introducción a n8n: Conceptos claves e Instalación con Docker Compose 8

Qué conviene aprender primero dentro de n8n

Al principio no necesitas tocarlo todo. Lo más útil es familiarizarte con estos nodos y conceptos:

  • Manual Trigger, para pruebas manuales.
  • Schedule Trigger, para ejecutar flujos por horario.
  • Set, para crear o modificar datos.
  • HTTP Request, para hablar con APIs.
  • If, para tomar decisiones dentro del flujo.
  • Code, para lógica personalizada.
  • Credentials, para guardar accesos correctamente.

Si dominas eso, ya puedes construir automatizaciones bastante útiles sin agobiarte con todo el catálogo de nodos.

Errores típicos de principiante

  1. El primero es no mirar bien qué datos salen de cada nodo. En n8n, si no entiendes la salida de un bloque, te pierdes rápido.
  2. El segundo es activar un workflow sin probarlo manualmente.
  3. El tercero es pegar tokens o contraseñas a mano en vez de usar Credentials.
  4. Y el cuarto, muy común, es pensar que n8n va a resolver procesos mal definidos. Automatizar algo no arregla un proceso caótico, simplemente lo ejecuta más rápido.

n8n se ha hecho un hueco muy serio porque combina facilidad de entrada con bastante profundidad técnica. Puedes empezar construyendo flujos simples con cuatro nodos y, sin cambiar de herramienta, terminar montando automatizaciones complejas, integraciones internas o procesos de infraestructura bastante potentes. Su documentación oficial sigue apostando por el despliegue self-hosted, mantiene Docker Compose como vía estándar de instalación y recomienda revisar actualizaciones con frecuencia por su ritmo de releases.

Lo importante al principio no es querer aprenderlo todo en una tarde, sino entender bien su idioma. Si ya sabes qué es un workflow, qué hace un node, qué dispara un trigger y qué guarda una execution, has pasado la parte más confusa. A partir de ahí, todo empieza a tener bastante más sentido.

Fin del Artículo. ¡Cuéntanos algo en los Comentarios!

Temas Relacionados: Software Docker N8N
Redactor del Artículo: Raúl Unzué

Raúl Unzué

Soy un apasionado de la virtualización con más de 20 años de experiencia, especializado en soluciones como VMware(premio vExpert y vExpert Pro desde 2013), Proxmox e Hyper-V. Durante mi carrera, he ayudado a empresas a optimizar sus infraestructuras TI mientras comparto mis conocimientos como redactor IT. Mi objetivo es traducir lo complejo en algo práctico y accesible, combinando teoría con experiencia real. Si te interesa la virtualización, las herramientas TI o simplemente aprender algo nuevo, espero ayudarte con mis artículos.